home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / qscr12.arc / QSCR.DOC < prev    next >
Text File  |  1989-12-25  |  38KB  |  1,051 lines
  1.  
  2.  
  3.                   QScr
  4.  
  5.  
  6.  
  7.                   QuickScreen text conversion utility
  8.  
  9.  
  10.  
  11.                   Version  1.2
  12.                   Released 12-15-89
  13.  
  14.  
  15.  
  16.  
  17.                   Herron Software
  18.                   P.O. Box 1288
  19.                   Battle Ground, Washington  98604
  20.  
  21.  
  22.  
  23.  
  24.          COPYRIGHT 1988, 1989 Phil Herron.  ALL RIGHTS RESERVED.
  25.  
  26.  
  27.                   DISCLAIMER OF WARRANTY
  28.          __________________________________________
  29.  
  30.  
  31.  
  32.          THIS PRODUCT IS PROVIDED FOR EVALUATION, AS IS
  33.          AND WITHOUT WARRANTY OF ANY KIND.  THE AUTHOR
  34.          MAKES NO EXPRESS OR IMPLIED WARRANTIES,
  35.          INCLUDING BUT NOT LIMITED TO MERCHANTABILITY
  36.          OR FITNESS FOR ANY PURPOSE.  IN NO EVENT SHALL
  37.          THE AUTHOR BE LIABLE FOR LOSS OF PROFIT OR ANY
  38.          OTHER COMMERCIAL DAMAGE ARISING FROM EITHER
  39.          THE USE OF OR THE INABILITY TO USE THIS PRODUCT.
  40.  
  41.  
  42.  
  43.          This product should be thoroughly evaluated
  44.          using backed up or noncritical data and files.
  45.  
  46.  
  47.  
  48.  
  49.    ______________________________________________________________
  50.  
  51.    Evaluation Preface                                     Section
  52.    ______________________________________________________________
  53.  
  54.    Shareware............................................... 0.1.0
  55.      What it is............................................ 0.1.1
  56.      License Terms......................................... 0.1.2
  57.      Registration.......................................... 0.1.3
  58.        Benefits, Forms, Registration fees,
  59.        Quantity discounts, Combined orders
  60.  
  61.    Evaluation.............................................. 0.2.0
  62.      Evaluation Version.................................... 0.2.1
  63.      Evaluation Menu....................................... 0.2.2
  64.      Virus Prevention...................................... 0.2.3
  65.  
  66.  
  67.  
  68.    _____________________________
  69.  
  70.    0.1.0          Shareware
  71.    _____________________________
  72.  
  73.  
  74.  
  75.    0.1.1   The SHAREWARE Concept
  76.    _____________________________
  77.  
  78.    "Shareware" is a software distribution method which enables
  79.    the potential user to obtain software at very low initial
  80.    cost, for evaluation on a trial basis.
  81.  
  82.    You can evaluate the software in your own environment, on your
  83.    own machine, with the programs and data that you normally use.
  84.    You're not required to become a registered user unless the
  85.    software meets your needs.
  86.  
  87.    Another benefit of Shareware is lower pricing.  By minimizing
  88.    the marketing and advertising expenses associated with more
  89.    traditional software distribution methods, Shareware products
  90.    can be priced lower.  You don't pay for what you don't need or
  91.    use.
  92.  
  93.    You are encouraged to share the evaluation version of this
  94.    software with others, so long as you follow the limitations
  95.    set forth in the LICENSE TERMS section below.
  96.  
  97.  
  98.    0.1.2   LICENSE TERMS
  99.    _____________________
  100.  
  101.    This product and its documentation are copyrighted and owned
  102.    solely by the author, who reserves all rights to any benefits
  103.    derived from it.  It is distinctly separate from, and should
  104.    not be confused with, those categories of software known as
  105.    "public domain" or "freeware."
  106.  
  107.    You are granted the right to use the evaluation version of
  108.    this software on a trial basis for a limited amount of time,
  109.    to decide whether to continue using (and therefore whether
  110.    to register) the product.
  111.  
  112.    You can transmit this evaluation version to associates by
  113.    copying on diskette or uploading to electronic bulletin board
  114.    services, so long as the following CONDITIONS are met:
  115.  
  116.      (a) The program and its documentation file must be
  117.          distributed together.
  118.  
  119.      (b) The program and its documentation must not be
  120.          altered in any way.  If you wish to include
  121.          notes for other evaluators, please add them in
  122.          a separate file and include that file along
  123.          with the program and documentation files.
  124.  
  125.  
  126.    0.1.3   REGISTRATION
  127.    ____________________
  128.  
  129.    When you send in the registration form and fee, you'll
  130.    receive by return mail a diskette containing the latest
  131.    REGISTERED version of the program and documentation.
  132.  
  133.  
  134.    BENEFITS OF REGISTRATION
  135.  
  136.      The registered version WILL NOT include the Evaluation Menu
  137.      front-end, startup time-delay or forms-printing sections of
  138.      this version.  Thus it will be more convenient to use, from
  139.      either the DOS prompt or from batch files.  It will also be
  140.      12k-15K bytes smaller, for more efficient disk storage and
  141.      faster loading.
  142.  
  143.      The registered version WILL include any new functions
  144.      or enhancements made to date.
  145.  
  146.      You will receive notification of future updates and
  147.      new products.
  148.  
  149.      You will be able to upgrade to newer versions at a
  150.      reduced cost.
  151.  
  152.  
  153.    REGISTRATION FORM
  154.  
  155.      The registration form and a pre-addressed mailing cover
  156.      can be printed from the "Forms Printing" selection of
  157.      the Evaluation menu, discussed in section 0.2.2 below.
  158.  
  159.  
  160.    FEES
  161.  
  162.      The single-quantity registration fee is displayed on the
  163.      initial Evaluation Menu screen.  Higher quantities are
  164.      discussed below.
  165.  
  166.  
  167.    QUANTITY DISCOUNTS
  168.  
  169.      Each registered copy of this software will be licensed for
  170.      operation at a single location (on a single terminal or
  171.      computer) at any one time.  If you need to run the software
  172.      on more than one terminal or computer at the same time, the
  173.      appropriate number of registrations must be made.
  174.  
  175.      Multiple-quantity registration fees are displayed in the
  176.      "QUANTITY DISCOUNT" section of the Evaluation menu.
  177.  
  178.      You can take advantage of quantity discounts by ordering
  179.      multiple registrations of one program or single
  180.      registrations of several different programs at the same
  181.      time.  You also save on shipping and handling charges
  182.      by registering several products together.
  183.  
  184.  
  185.    COMBINED ORDERS
  186.  
  187.      You can also take advantage of quantity discounts by
  188.      combining orders with associates:
  189.  
  190.      (1)   Complete a separate registration form for each person.
  191.               Each person's name, address and programs to be
  192.               registered are needed for support and update
  193.               notification purposes.
  194.  
  195.      (2)   Include only one standard shipping and handling charge.
  196.               Cross out the "Shipping & handling" amounts on
  197.               all but ONE registration form; the combined
  198.               order will be sent to the name and address on
  199.               that form.
  200.  
  201.      (3)   Mail all the forms together, with a single check/money
  202.               order for the total, in one envelope/mailing cover.
  203.  
  204.  
  205.  
  206.    _____________________________
  207.  
  208.    0.2.0          Evaluation
  209.    _____________________________
  210.  
  211.  
  212.  
  213.    0.2.1   EVALUATION VERSION
  214.    __________________________
  215.  
  216.    This software contains the complete and fully functional version
  217.    of the program, the latest available at the time of this release.
  218.  
  219.    The program itself is identical to the REGISTERED version.
  220.    An Evaluation Menu and forms-printing section were added
  221.    to ensure that:
  222.  
  223.      (a)   Registration information and forms will not
  224.            become separated from the program file.
  225.  
  226.      (b)   Users who might be unfamiliar with the process
  227.            of displaying a file's contents on the screen or
  228.            printer will have no difficulty learning about,
  229.            evaluating or registering this product.
  230.  
  231.  
  232.    0.2.2   EVALUATION MENU
  233.    _______________________
  234.  
  235.    The program is invoked from the DOS prompt by typing its name
  236.    and pressing the RETURN or ENTER key.
  237.  
  238.    The initial screen displays the warranty section and some
  239.    information about the program:
  240.  
  241.      Program name,
  242.      Version number,
  243.      Release date,
  244.      Single-quantity registration fee.
  245.  
  246.    It next displays the Shareware Product EVALUATION MENU.
  247.    A single key press will select the following functions
  248.    from the menu:
  249.  
  250.      ESC - EXIT to DOS without evaluating this program
  251.       R  - READ the documentation (THIS file)
  252.       x  - EVALUATE this program
  253.       Q  - QUANTITY Discount information
  254.       F  - FORMS printing menu - registration & mailer
  255.  
  256.    When you press "R" to READ the documentation, this file will
  257.    be shown one screen at a time.  The display pauses whenever the
  258.    screen becomes full, and prompts...
  259.  
  260.                      <downArrow> or Esc
  261.  
  262.    The <downArrow> character is similar to the "MORE" prompt in
  263.    other DOS utilities.  It indicates that more is available.
  264.    Press ESCape to exit back to the Evaluation Menu, or any normal
  265.    typing key to continue (space bar is a convenient key to use).
  266.  
  267.  
  268.    0.2.3   VIRUS PREVENTION
  269.    ________________________
  270.  
  271.    If you'd like to evaluate this software but you're not sure
  272.    where it's been, you can order a copy straight from the source.
  273.    See the SHAREWARE PRODUCT CATALOG section at the end of this file.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.    _________________________________________________________________
  280.  
  281.    Table of Contents                                         Section
  282.    _________________________________________________________________
  283.  
  284.    QScr....................................................... 1.0
  285.       Introduction............................................ 1.1
  286.       Explanation............................................. 1.2
  287.       System Requirements..................................... 1.3
  288.          Installing........................................... 1.3.1
  289.       Help.................................................... 1.4
  290.       Syntax.................................................. 1.5
  291.       Examples................................................ 1.6
  292.          Operating Screen..................................... 1.6.1
  293.       Applications............................................ 1.7
  294.          Menu system.......................................... 1.7.1
  295.          Tutorial system...................................... 1.7.2
  296.       Error Messages.......................................... 1.8
  297.       DOS ErrorLevel.......................................... 1.9
  298.       Version History......................................... 2.0
  299.  
  300.    Support.................................................... 9.0
  301.       Problem Resolution...................................... 9.1
  302.       Before Reporting........................................ 9.2
  303.       Reporting a problem..................................... 9.3
  304.       Custom Modifications.................................... 9.4
  305.       Correspondence.......................................... 9.5
  306.  
  307.    Shareware Product Catalog................................. 10.0
  308.  
  309.  
  310.  
  311.    ******************************************
  312.             NEW in this version
  313.    ******************************************
  314.  
  315.    * DOS ErrorLevel is now returned upon termination.
  316.  
  317.    * Text and background colors are now selectable.
  318.  
  319.  
  320.  
  321.  
  322. ______________________________________________________________
  323.  
  324.                QScr
  325. 1.0
  326.                QuickScreen text conversion utility
  327. ______________________________________________________________
  328.  
  329.  
  330.  
  331.  
  332. 1.1   INTRODUCTION
  333. __________________
  334.  
  335.    You probably know several ways to display small amounts of text
  336.    on screen from the DOS prompt: You can "echo" each individual
  337.    text line from a batch file, or you can use the DOS "type"
  338.    command to display the contents of a text file.  However,
  339.    neither method is fast enough to make the text appear
  340.    "instantaneously."
  341.  
  342.    QScr, on the other hand, processes any amount of text from a
  343.    few lines up to a full screen, into a form that can be
  344.    displayed much more rapidly.
  345.  
  346.  
  347.  
  348.  
  349. 1.2   EXPLANATION
  350. _________________
  351.  
  352.    QScr (QuickScreen converter) generates an executable COM file
  353.    from a text file, allowing much faster display of single-screen
  354.    text files such as menu screens.
  355.  
  356.    It will incorporate up to 24 lines of 80 characters from a text
  357.    file into a COM file; the processed text can then be displayed
  358.    rapidly by issuing the executable file name, either directly
  359.    from DOS or from within a batch routine.
  360.  
  361.    When the executable COM file name is invoked, it writes
  362.    directly to video memory instead of using the slower system
  363.    BIOS display routines.  It also writes to the correct video
  364.    memory address for the video adapter installed (color or
  365.    monochrome).
  366.  
  367.  
  368.    Color selection
  369.  
  370.       QScr displays a color selection box which allows
  371.       experimentation with foreground and background colors to
  372.       be used by the finished COM file.  Colors can be set for
  373.       best visual effect on systems with color adapters and
  374.       displays.
  375.  
  376.  
  377.    Video SNOW Prevention
  378.  
  379.       The output file employs direct screen writing to rapidly
  380.       send text to the display; this direct writing to video RAM
  381.       can produce video noise or 'snow' in certain systems
  382.       equipped with Color Graphics display Adapters.
  383.  
  384.       QScr's default mode ignores the possibility of video snow.
  385.       If the output file does cause snow, run QScr again with the
  386.       "/S" command line option to suppress it.  Output files
  387.       generated in the "/S" mode have a slightly slower screen-
  388.       writing speed.
  389.  
  390.  
  391.  
  392.  
  393. 1.3     SYSTEM REQUIREMENTS
  394. ___________________________
  395.  
  396.    PC, XT, AT or compatible.
  397.    DOS version 2.1 or later.
  398.    64K free memory.
  399.  
  400.  
  401.  
  402.  
  403. 1.3.1   INSTALLING
  404. __________________
  405.  
  406.    The program can be run from diskette or from hard disk.
  407.    No installation is necessary, other than copying the
  408.    files to a drive and directory of your choosing.
  409.  
  410.  
  411.  
  412.  
  413. 1.4   HELP
  414. __________
  415.  
  416.    Can't remember the command line syntax?
  417.    Issue the program's name without any parameters; it
  418.    will display a help screen, then return to the DOS prompt.
  419.  
  420.  
  421.  
  422.  
  423. 1.5   SYNTAX
  424. ____________
  425.  
  426.  
  427.                                         Snow suppression
  428.                                          /
  429.       QScr [inFileSpec] [outFileSpec] [/S]
  430.  
  431.  
  432.         Where FileSpec is the string needed to reference a file;
  433.         can also be shown as [d:][path][filename.ext].
  434.  
  435.         The minimum FileSpec needed is filename.ext. If the file
  436.         is in another directory and/or on another drive, the
  437.         drive name and/or path name must also be given.
  438.  
  439.         The complete FileSpec for a file named ThisFile.Doc
  440.         residing in drive A: in a subdirectory named ThisSub is
  441.  
  442.               A:\ThisSub\ThisFile.Doc
  443.  
  444.         For further information on filespecs, see your DOS manual.
  445.  
  446.  
  447.  
  448.       [inFileSpec] - The input file must contain displayable text
  449.         and cannot have an extension of COM, EXE, OBJ, BIN.
  450.  
  451.  
  452.       [outFileSpec] - The output file incorporates up to 24 lines
  453.         of 80 characters from the top of the input file into an
  454.         executable (COM) file.
  455.  
  456.         If not specified on the command line, the output file
  457.         will have the same name and path as the input file, but
  458.         with a COM extension.  It may be prefaced with drive and
  459.         path specifications.
  460.  
  461.         Any identically-named COM file on the default or
  462.         specified disk/subdirectory will be overwritten.  To
  463.         retain it, specify a different filename and/or path for
  464.         the output file on the command line.
  465.  
  466.  
  467.  
  468.  
  469. 1.6   EXAMPLES
  470. ______________
  471.  
  472.    QScr test.txt Zip.Com /S       creates Zip.COM with video snow
  473.                                   suppression enabled.  The output
  474.                                   file could be specified as
  475.                                   "Zip.Com", "Zip.Zip", or just
  476.                                   "Zip", since its extension is
  477.                                   ALWAYS forced to .COM.
  478.  
  479.    QScr test.txt                  creates Test.COM with no snow
  480.                                   suppression, for higher speed.
  481.  
  482.  
  483.  
  484.  
  485. 1.6.1   OPERATING SCREEN
  486. ________________________
  487.  
  488.    The operating screen appears whenever "QScr" is issued from the
  489.    DOS prompt (or from a batch file) with at least an input file
  490.    specification; in this example, the complete command line is:
  491.  
  492.             QScr test.txt
  493.  
  494.    and the screen displays:
  495.  
  496.     __QScr________________________
  497.    |______________________________|
  498.  
  499.    Select text (foreground) & screen (background) colors:
  500.        __________________________________
  501.       |                                  |
  502.       |         ForeGround  White      7 |
  503.       |         BackGround  Black      0 |
  504.       |__________________________________|
  505.  
  506.    The color selection box above initially displays the default
  507.    colors (the text and background colors in use when Qscr is
  508.    invoked); if your system uses other default colors, they will
  509.    be used first in the box.
  510.  
  511.    You can change foreground colors with the Up- and Down-arrow
  512.    keys, and background colors with the Left- and Right-arrow
  513.    keys.  You can also use the "D" key to return to the default
  514.    colors, and the "S" key to swap foreground and background
  515.    colors.  Straight color swaps are hampered by the fact that
  516.    the background is limited to colors 0 through 7; if the
  517.    foreground color is greater than 7, swapping it to the
  518.    background will remap it to its low-intensity equivalent.
  519.    The complete list of colors is:
  520.  
  521.      Low intensity   High intensity
  522.      ═════════════   ═══════════════
  523.       0 - Black        8 - Gray
  524.       1 - Blue         9 - Lt. Blue
  525.       2 - Green       10 - Lt. Green
  526.       3 - Cyan        11 - Lt. Cyan
  527.       4 - Red         12 - Lt. Red
  528.       5 - Magenta     13 - Lt. Magenta
  529.       6 - Brown       14 - Yellow (Lt. Brown)
  530.       7 - White       15 - Intense White
  531.  
  532.  
  533.  
  534.      NOTE for MONOCHROME display adapters:
  535.  
  536.        If the output COM file is to be used on a system employing
  537.        a monochrome display adapter, you should not use either
  538.        shade of blue for the foreground; blue (1) or light blue
  539.        (9) cause all text in that color to be underlined.
  540.  
  541.        Most other color combinations display white text on a black
  542.        background when used with a mono adapter, except for
  543.        several that produce "invisible" text, and several that
  544.        produce "reverse video" (dark text on a white background):
  545.  
  546.          Foreground    Background    Effect
  547.          ----------    ----------    ----------
  548.           Black     on   Black        not visible
  549.           Gray      on   Black        not visible
  550.           Black     on   White        reverse video
  551.           Gray      on   White        reverse video
  552.  
  553.  
  554.  
  555.    When colors are set, press the <return> key to accept them.
  556.    Next, the screen displays
  557.  
  558.       Creating TEST.COM
  559.  
  560.    and an activity indicator during processing.  When finished,
  561.    the DOS prompt reappears.  Now you can try out the new
  562.    executable form of your text by simply entering
  563.  
  564.             Test <return>
  565.  
  566.    The original Test.Txt file has not been disturbed, so you can
  567.    run QScr on it any number of times to experiment with other
  568.    colors or to try it with and without video snow suppression.
  569.    A convenient way to compare colors or snow conditions is to
  570.    create a different COM file for each new combination:
  571.  
  572.             QScr test.txt 1 /S   (creates 1.Com with suppression)
  573.             QScr test.txt 2      (creates 2.Com with NO suppression)
  574.  
  575.    Then you can rapidly compare the results by issuing "1" and "2"
  576.    from the DOS prompt.
  577.  
  578.  
  579.    Source File Retention
  580.  
  581.       After the COM file is generated, the source text file can be
  582.       deleted if disk space is at a premium (a backup copy is
  583.       still a good idea, however).  For future editing, run the
  584.       COM file to display the text, then use a text utility with
  585.       "cut and paste" capabilities to import the screen back into
  586.       a temporary text file.  Edit, then QScr again.
  587.  
  588.  
  589.  
  590.  
  591. 1.7   APPLICATIONS
  592. __________________
  593.  
  594.    Text files converted to executable form by QScr can be used
  595.    alone to display help information, or they can be called from
  596.    batch files as in the following examples.
  597.  
  598.  
  599.  
  600.  
  601. 1.7.1   MENU SYSTEM
  602. ___________________
  603.  
  604.    This application can be expanded from the simple menus shown
  605.    here to any number of sub-menus, programs and utility batch
  606.    files.
  607.  
  608.  
  609.    M.Txt: Contains text for Main Menu
  610.           Issue "QScr M.txt" to convert to executable file
  611.       ╔══════════════════════╦══════════════════════════════╗
  612.       ║                      ║▓▓▓▓       Main Directory ▓▓▓▓║
  613.       ║                      ╚══════════════════════════════╣
  614.       ║                                                     ║
  615.       ║    A    -  Accounting Menu                          ║
  616.       ║                                                     ║
  617.       ║    W    -  Word Processor                           ║
  618.       ║                                                     ║
  619.       ║    FA   -  Format diskette in drive A               ║
  620.       ║    FB   -  Format diskette in drive B               ║
  621.       ║                                                     ║
  622.       ║                                                     ║
  623.       ║                                                     ║
  624.       ║                                                     ║
  625.       ║    M    -  Display this Menu                        ║
  626.       ╚═════════════════════════════════════════════════════╝
  627.  
  628.    Functions callable from the Main Menu above:
  629.       A is an executable file A.Com, produced from A.Txt below,
  630.          that displays the Accounting Menu.
  631.       W is an executable program name or a batch file that sets up
  632.          and runs a word processor/text editor.
  633.       FA and FB are batch files that format diskettes.
  634.  
  635.  
  636.    A.Txt: Contains text for Accounting Menu
  637.           Issue "QScr A.txt" to convert to executable file
  638.       ╔══════════════════════╦══════════════════════════════╗
  639.       ║                      ║▓▓▓▓ Accounting Directory ▓▓▓▓║
  640.       ║                      ╚══════════════════════════════╣
  641.       ║                                                     ║
  642.       ║    PR   -  PayRoll                                  ║
  643.       ║                                                     ║
  644.       ║    AP   -  Accounts Payable                         ║
  645.       ║                                                     ║
  646.       ║    AR   -  Accounts Receivable                      ║
  647.       ║                                                     ║
  648.       ║    GL   -  General Ledger                           ║
  649.       ║                                                     ║
  650.       ║                                                     ║
  651.       ║                                                     ║
  652.       ║    M    -  Main Menu                                ║
  653.       ╚═════════════════════════════════════════════════════╝
  654.  
  655.  
  656.       PR, AP, AR, GL are executable program names or batch files that
  657.          run the appropriate programs.
  658.  
  659.  
  660.  
  661.  
  662. 1.7.2   TUTORIAL SYSTEM
  663. _______________________
  664.  
  665.    This application can be used to present tutorials or
  666.    demonstrations of any size.  After setup, no special knowledge
  667.    or utilities are needed by users of such a system; they need
  668.    only press a key to advance through the sequence.
  669.  
  670.    Executable text files:
  671.          To build a tutorial consisting of three screens of text,
  672.          separate each screen into a separate text file, then run
  673.          QScr on each one to generate three separate .COM files.
  674.          In this example, the files are named 1.COM, 2.COM and
  675.          3.COM.
  676.  
  677.    Control file:
  678.          In this example, a batch file named TUTOR.BAT will
  679.          control the display sequence and wait for user-
  680.          interaction before displaying the next screen.
  681.          The batch command "pause" is used after each .COM
  682.          file invocation, to display the prompt
  683.  
  684.                "Strike a key when ready . . ."
  685.  
  686.          at the bottom of each screen.  TUTOR.BAT can be easily
  687.          modified to change the display sequence, or expanded to
  688.          control any number of executable text files.
  689.  
  690.          For more interactive tutorials, several utilities are
  691.          available to allow branching depending on what key a user
  692.          presses.  Other utilities can be used to make a tutorial
  693.          or demo advance automatically after a time delay.  If
  694.          you have need for such capabilities, contact us with
  695.          the details.
  696.  
  697.  
  698.          Listing of TUTOR.BAT:
  699.  
  700.             :::: Tutorial Control batch program
  701.             echo off
  702.             1
  703.             pause
  704.             2
  705.             pause
  706.             3
  707.             pause
  708.  
  709.    Notes:
  710.       1 - There are several ways to convert the above listing
  711.           into batch file form.  One is to copy this entire file
  712.           to another named "Tutor.Bat", delete everything except
  713.           the listing, then delete the leading spaces on the left
  714.           side so each line begins in column one.
  715.           Another is to display the listing on screen and use a
  716.           memory-resident notepad to "cut and paste" it into a
  717.           batch file.
  718.  
  719.       2 - Multiple colons in the listing are used for comment
  720.           lines.
  721.  
  722.  
  723.  
  724.  
  725. 1.8   ERROR MESSAGES
  726. ____________________
  727.  
  728.   Too many parameters on command line
  729.     The command line cannot contain more than three parameters.
  730.  
  731.   <srcFile> - illegal extension - text file required
  732.     The input file cannot have an extension of COM, EXE, OBJ, or BIN.
  733.  
  734.   <inFile> not found
  735.  
  736.   Cannot create <outFile>
  737.  
  738.   Cannot read input file <inFile>
  739.  
  740.   Cannot write code to <outFile>
  741.     Problem writing executable code section.
  742.  
  743.   Cannot write text to <outFile>
  744.     Problem writing text section.
  745.  
  746.  
  747.  
  748.  
  749. 1.9   DOS ERRORLEVEL
  750. ____________________
  751.  
  752.   Upon termination, the program returns a DOS ErrorLevel value
  753.   which indicates how the program ended, and which can be used for
  754.   subsequent operations in a batch file.  For further information,
  755.   see the "IF ERRORLEVEL" batch command in your DOS manual.
  756.  
  757.   ErrorLevel list:
  758.  
  759.       0  -  Successful completion.
  760.       1  -  No parameters specified on command line.
  761.       2  -  Input file not found.
  762.       3  -  Too many parameters on command line.
  763.       4  -  Illegal input file extension - text file required.
  764.       5  -  Cannot read input file.
  765.       6  -  Cannot create output file.
  766.       7  -  Cannot write code to output file.
  767.       8  -  Cannot write text to output file.
  768.  
  769.  
  770.  
  771.  
  772. 2.0   VERSION HISTORY
  773. _____________________
  774.  
  775.    1.00  Initial release.
  776.    1.04  Added trapping of illegal input file extensions.
  777.    1.1   Added expansion of tab characters.
  778.    1.13  Added selectable text and background colors.
  779.    1.18  Added Default and Swap selections for colors.
  780.    1.2   Added DOS ErrorLevels
  781.  
  782.  
  783.  
  784.  
  785. _________________________________________________________________
  786.  
  787. 9.0            Support
  788. _________________________________________________________________
  789.  
  790.  
  791.  
  792.  
  793. 9.1   PROBLEM RESOLUTION
  794. ________________________
  795.  
  796.    Please document and report any anomaly in program operation,
  797.    whether it's a genuine "bug" or just some feature of the
  798.    program that particularly "bugs" you.
  799.  
  800.    If you're the first person to document and report a problem
  801.    that we agree needs attention, you'll receive a free upgrade
  802.    with the correction when it's been made.  If you're a
  803.    registered user, you'll get the upgraded registered version;
  804.    if you haven't yet registered, you'll get the upgraded
  805.    evaluation version.
  806.  
  807.  
  808.  
  809.  
  810. 9.2   BEFORE REPORTING
  811. ______________________
  812.  
  813.    Things to try prior to reporting a problem:
  814.  
  815.       1 - Reread the documentation to make sure you understand
  816.           what we thought we understood when we wrote it.
  817.  
  818.       2 - If the system reports "Bad command or file name" when
  819.           you attempt to run the program, its executable file
  820.           (or at least the file name you specified) was not found.
  821.  
  822.           First, make sure no typos or misspellings have crept
  823.           into your command line; next, try changing your PATH
  824.           setting, or make the drive & directory where the program
  825.           resides the "current" drive & directory.
  826.  
  827.       3 - If the program is being run from a batch file, try
  828.           deleting lines previous to the line that actually
  829.           invokes the program, to see if some prior activity
  830.           is causing the problem.
  831.  
  832.       4 - If you have any memory-resident or "TSR" utilities
  833.           installed (pop-up calculators/note pads, keyboard
  834.           enhancements, etc.), try removing them from memory
  835.           and running the program again to see if the problem
  836.           reoccurs.
  837.  
  838.  
  839.  
  840.  
  841. 9.3   REPORTING A PROBLEM
  842. _________________________
  843.  
  844.    If the problem persists, please document it as completely and
  845.    accurately as possible; we have to be able to duplicate it
  846.    before we can begin to resolve it.
  847.  
  848.    Include at least the following:
  849.  
  850.       1 - Version of DOS you are using.
  851.       2 - Machine type, drives, memory, etc.
  852.       3 - Programs executed prior to the problem.
  853.       4 - Problem program's name and version number.
  854.       5 - Where and how you obtained the problem program.
  855.       6 - Address and/or phone number where you can be contacted.
  856.       7 - Anything you can think of that might relate to the problem;
  857.           for example, listings of your AUTOEXEC.BAT and CONFIG.SYS
  858.           files, or any batch files used to run the program.
  859.       8 - Any relevant printouts.
  860.  
  861.  
  862.    NOTE: If you're a registered user, you'll find the utility
  863.          UserResp.Exe on the distribution diskette; it can be used
  864.          to print a pre-addressed mailer and a problem report.
  865.  
  866.          If you have not yet registered, send problem reports to the
  867.          address below (or print the pre-addressed mailer from the
  868.          Evaluation Menu).
  869.  
  870.  
  871.  
  872.  
  873. 9.4   CUSTOM MODIFICATIONS
  874. __________________________
  875.  
  876.    If you need custom modifications to this software for your
  877.    particular application, please write to the below address
  878.    with complete details of your requirements.
  879.  
  880.  
  881.  
  882.  
  883. 9.5   CORRESPONDENCE
  884. ____________________
  885.  
  886.    We welcome any comments or suggestions you might have
  887.    concerning improvements and future enhancements to this
  888.    product.  Send all correspondence and orders to:
  889.  
  890.              Phil Herron
  891.              P.O. Box 1288
  892.              Battle Ground, Washington  USA  98604
  893.  
  894.  
  895.  
  896.  
  897. _________________________________________________________________
  898.  
  899. 10.0           Shareware Product Catalog
  900. _________________________________________________________________
  901.  
  902.  
  903.   This section contains a list of our other Shareware products;
  904.   it may be updated whenever products are added or changed.
  905.           ____________________________________________
  906.  
  907.   If you'd like to try any of the programs in this catalog, but
  908.   can't find them locally, you can order evaluation copies
  909.   straight from the source...
  910.  
  911.   Five programs and their associated documentation will fit on each
  912.   5.25 inch 362Kb diskette; the basic single-disk fee of $4.00
  913.   covers the cost of the first disk, shipping and handling.  Add an
  914.   additional dollar for each additional disk of programs you want to
  915.   evaluate ($4.00 for 1 to 5 programs, $5.00 for 6-10, $6.00 for
  916.   11-15, etc.; all payments in U.S. funds).  If your address is
  917.   outside the U.S. and Canada, add an additional $3.00.
  918.  
  919.   Include your mailing address and the names of the programs.  By
  920.   return mail you'll receive the latest versions of those programs
  921.   for evaluation.
  922.           ____________________________________________
  923.  
  924.   "Shareware" is a software distribution method which enables the
  925.   potential user to obtain software at very low initial cost, for
  926.   evaluation on a trial basis.  You can evaluate the software in your
  927.   own environment, on your own machine, with the programs and data
  928.   that you normally use.  You're not required to become a registered
  929.   user unless the software meets your needs.
  930.           ____________________________________________
  931.  
  932.           PROGRAM SPECIFICATIONS AND REGISTRATION FEES
  933.                    MAY CHANGE WITHOUT NOTICE.
  934.           ____________________________________________
  935.  
  936.  
  937. ChkD  v1.1
  938.   Check_Disk_space reports disk drive space usage.  It reports drive
  939.   cluster size, then drive space TOTAL, FREE and USED by actual value
  940.   and by percentage.  It is faster and more convenient than the DOS
  941.   "dir" or "chkdsk" utilities for displaying drive information.
  942.  
  943. ChkM  v1.1
  944.   Check_Memory_space reports standard system memory (RAM) space usage.
  945.   It reports memory space TOTAL, FREE and USED by actual value and by
  946.   percentage.  It is faster and more convenient than the DOS "chkdsk"
  947.   utility for displaying system memory information.
  948.  
  949. CleanOut  v1.3
  950.   CLEANOUT searches all directories of the default drive for file(s)
  951.   specified on command line (wildcards * and ? are legal).  Each time
  952.   a matching file is found, the user is prompted for disposition:
  953.   Delete or Save.  File contents, either text or binary, can be VIEWED
  954.   before deciding.  A single press of the "S" key saves a file; a
  955.   double press of the "D" key deletes it.  An optional mode allows
  956.   deletions without confirmation.  Useful for cleaning out .BAK file
  957.   leftovers, among others.
  958.  
  959. CleanTxt  v1.1
  960.   CleanTxt converts WordStar text files to straight ASCII.  It strips
  961.   out certain control characters, and will optionally expand tab
  962.   characters to the appropriate number of spaces.
  963.  
  964. CleanZ  v1.2
  965.   Most text editors won't read files beyond the first control-Z end-
  966.   of-file character.  Control-Z's can become embedded in a text file
  967.   when several files are combined using the DOS "type" command.
  968.   CleanZ will strip out each control-Z, or it will optionally replace
  969.   each with a seldom-used character, to ease the task of locating the
  970.   former boundaries in combined files.
  971.  
  972. FindF  v1.1
  973.   FindFile searches the default drive for specified files, and writes
  974.   the file information to screen or disk. Useful for locating
  975.   misplaced files or for generating a listing of all files and
  976.   subdirectories on the default drive.
  977.  
  978. Gen  v1.2
  979.   Gen replaces several trial-and-error methods of building specific-
  980.   sized files for printer, storage or timing tests.  It generates
  981.   files of any size from zero to twenty million bytes, much faster
  982.   than typing random characters into a text editor.  Besides
  983.   generating files on disk, it can send a specific number of
  984.   characters directly to the console screen, printer or
  985.   other DOS device.
  986.  
  987. KeyCode  v1.1
  988.   KeyCode responds to each press of a key or combination of keys by
  989.   displaying the key or combination pressed, its associated Ascii
  990.   character (if any), key type (normal or extended), Ascii code and
  991.   Scan code.
  992.  
  993. KeySet  v1.1
  994.   KeySet's interactive mode displays the current settings of the
  995.   CapsLock, NumLock, ScrollLock and PrtSc (Print Screen) keys, and
  996.   allows them to be changed.  The command line mode directly sets the
  997.   keys to specified states, allowing use of a batch file for
  998.   presetting at system bootup or between applications.
  999.  
  1000. PrinTest  v1.2
  1001.   PrinTest repetitively displays the status of ports assigned to
  1002.   parallel printer interfaces. It can be used to isolate problems to
  1003.   the printer interface card, the cable or the printer itself.  It
  1004.   reports printer and port number, status byte and status condition.
  1005.  
  1006. Qscr  v1.2
  1007.   QuickScreen converts a single text screen to an executable file for
  1008.   more rapid display.  The resulting .COM file will write a screen of
  1009.   text much faster than batch file ECHO statements.  Useful for
  1010.   setting up compact menu systems, demos and tutorials.
  1011.  
  1012. ScanF  v1.1
  1013.   Scan_File speeds up the search for ASCII text strings within
  1014.   executable files.  It filters out the unintelligible control and
  1015.   extended characters, allows user definition of minimum string length
  1016.   for display, and pauses after each screen of information.
  1017.  
  1018. ScanM  v1.1
  1019.   Scan_Memory speeds up the search for ASCII text such as ROM
  1020.   copyright statements and machine identification, anywhere within
  1021.   standard system memory space. It filters out the unintelligible
  1022.   control and extended characters, displays each string longer than
  1023.   three characters, and pauses after each screen of information.
  1024.  
  1025. Split  v1.1
  1026.   Split breaks huge text files down into smaller ones that will fit
  1027.   into your text editor or onto a diskette. Useful for working on
  1028.   large files with a limited-filesize memory-resident notepad utility.
  1029.  
  1030. StoRm  v1.1
  1031.   STOrage_RooM reports the amount of disk space required for storage
  1032.   of a specified file or group of files on any disk, using any version
  1033.   of DOS.  It takes into account all of the factors involved in
  1034.   determining file storage size.  It locates files specified on the
  1035.   command line and determines their actual total size and the amount
  1036.   of room needed to store them.  Useful for determining the number of
  1037.   files that will fit on a disk.
  1038.  
  1039. PhLBL  v0.75 (not yet released)
  1040.   Label printer using text stored in ASCII files.  Each label/card/
  1041.   tag can contain embedded commands for date, time, series (nn OF nn),
  1042.   consecutive serial numbering, left margin, and selectable printer
  1043.   attribute for each line; 5, 10, 12, 17 or 20 characters per inch
  1044.   pitch, normal/bold/underlined on Epson compatible dot-matrix
  1045.   printers.
  1046.  
  1047.  _______________________________________________________________
  1048. |                                                               |
  1049. |        COPYRIGHT 1989 Phil Herron.  ALL RIGHTS RESERVED.      |
  1050. |_______________________________________________________________|
  1051.